home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 1 / Gold Medal Software Volume 1 (Gold Medal) (1994).iso / prog / printers.arj / PRINTERS.DOC < prev    next >
Encoding:
Text File  |  1993-11-01  |  16.1 KB  |  311 lines
  1.  
  2.  
  3.  ╔════════════════════════════════════════════════════════════════════════════╗
  4.  ║                                                                            ║
  5.  ║ ░░▒▒▓▓██▓▓▒▒░░ ░░▒▒▓▓██▓▓▒▒░░    PRINTERS    ░░▒▒▓▓██▓▓▒▒░░ ░░▒▒▓▓██▓▓▒▒░░ ║
  6.  ║                                                                            ║
  7.  ║     This program is being distributed as Shareware. Please feel free       ║
  8.  ║   to copy and distribute as you like. Under No Terms may you charge for    ║
  9.  ║   distribution, except for media costs and shipping costs. If you use      ║
  10.  ║   this software and find that is has reduced your developement cycle       ║
  11.  ║   time dramatically, then please register today. In any event, please      ║
  12.  ║   pass it on so someone else can gain the benefits offered.                ║
  13.  ║                                                                            ║
  14.  ║       PRINTERS (C)1993 has been developed by Micro Alpha Computer          ║
  15.  ║   Applications. All rights to PRINTERS are reserved by the Authors:        ║
  16.  ║                                                                            ║
  17.  ║                              Micro Alpha                                   ║
  18.  ║                       George Wilcken & Bill Guy                            ║
  19.  ║                                                                            ║
  20.  ║   To Register, Send $39.00 to:                                             ║
  21.  ║                                                                            ║
  22.  ║                       Micro Alpha Computer Applications                    ║
  23.  ║                       702 Deering Drive                                    ║
  24.  ║                       Akron, Ohio  44313-5745                              ║
  25.  ║                                                                            ║
  26.  ║                                                                            ║
  27.  ║                          SUPPORT SHAREWARE TODAY!                          ║
  28.  ║                                                                            ║
  29.  ║                ░░▒▒▓▓██▓▓▒▒░░    DISCLAIMER  ░░▒▒▓▓██▓▓▒▒░░                ║
  30.  ║                                                                            ║
  31.  ║                                 Micro Alpha                                ║
  32.  ║   assumes no responsibility for the program or damages that it may cause.  ║
  33.  ║             This software is being sold and distributed AS IS.             ║
  34.  ║                                                                            ║
  35.  ║ ░░▒▒▓▓██▓▓▒▒░░ ░░▒▒▓▓██▓▓▒▒░░ ░░▒▒▓▓██▓▓▒▒░░ ░░▒▒▓▓██▓▓▒▒░░ ░░▒▒▓▓██▓▓▒▒░░ ║
  36.  ╚════════════════════════════════════════════════════════════════════════════╝
  37.  
  38.                 ╔══════════════════════════════════════════════╗
  39.                 ║░░▒▒▓▓██▓▓▒▒░░ WHAT IS PRINTERS ░░▒▒▓▓██▓▓▒▒░░║
  40.                 ╚══════════════════════════════════════════════╝
  41.  
  42.    PRINTERS is a program which will allow you to add complete printer
  43. independence to your Clarion 2.XXX applications.
  44.  
  45.  
  46.                 ╔══════════════════════════════════════════════╗
  47.                 ║░░▒▒▓▓██▓▓▒▒░░    THE PROBLEM   ░░▒▒▓▓██▓▓▒▒░░║
  48.                 ╚══════════════════════════════════════════════╝
  49.  
  50.     As developers for a product intended to be distributed to a large number
  51.  of users, there is no way to determine which printer will be used at the
  52.  end user site. Although using a string constant to contain the HEX printer
  53.  codes ( eg. '<27>G' ) is supported in clarion reports, they must be included
  54.  into the report with a specific printer in mind. Fortunatly, Clarion also
  55.  supports the use of string variables as printer control codes which
  56.  facilitates multiple printer support, but assumes that the string will contain
  57.  a hexidecimal printer code. Supplying a file containing all of the hex
  58.  codes for all of the supported printers requires that the developer provide
  59.  printer updates. Once a printer has been selected, printer port assignment
  60.  must also be user selectable.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                                                     PG 1
  67.                 ╔══════════════════════════════════════════════╗
  68.                 ║░░▒▒▓▓██▓▓▒▒░░   THE SOLUTION   ░░▒▒▓▓██▓▓▒▒░░║
  69.                 ╚══════════════════════════════════════════════╝
  70.  
  71.    Have the end user select their printer from an initial list of printers.
  72.  If their printer is not included in the list, allow them to add it using the
  73.  printer codes contained in their printer manual. Prompt for a printer port
  74.  selection and write the results to a single record file containing all the
  75.  hex control codes and port information. Use the variable field of this end
  76.  user generated file to develope your report from within the Designer or
  77.  Editor.
  78.  
  79.                 ╔══════════════════════════════════════════════╗
  80.                 ║░░▒▒▓▓██▓▓▒▒░░    THE CONCEPT   ░░▒▒▓▓██▓▓▒▒░░║
  81.                 ╚══════════════════════════════════════════════╝
  82.  
  83.     The first step in developing PRINTERS was to convert Clarion's MATRIX.CTL
  84.   and LASER.CTL (used by report writer) into Clarion file format to allow
  85.   ASCII control code editing and easy printer selection from within a table.
  86.   Next was to convert these files to their HEX counterparts to be used from
  87.   within the designer's report generator and editor written code. These basic
  88.   needs prompted the development of C.R.A.B. by Micro Alpha in 1991. C.R.A.B.
  89.   allowed the developer to add multi printer support to their clarion apps.
  90.   but required that the developer generate the code for printer pick lists and
  91.   file manipulation. C.R.A.B. also lacked the ability to allow the end user
  92.   to modify the printer codes for existing printers as well as add or delete
  93.   printers from the initial data file. Thus PRINTERS was born.
  94.     PRINTERS picks up the ball where C.R.A.B. left off and takes it for the
  95.   touch down! PRINTERS is a self contained program which converts and
  96.   manipulates the printer control files allowing the end user complete
  97.   flexibility. You simply include the PRINTERS.EXE with your application and
  98.   call it using a "RUN" command from within your app. Uppon successfull
  99.   selection of a printer by your end user the program will generate the
  100.   PRN_CDS.DAT file containing all of the codes for their printer. The screens
  101.   for PRINTERS are generic and should fit in easily with your application.
  102.  
  103.                 ╔══════════════════════════════════════════════╗
  104.                 ║░░▒▒▓▓██▓▓▒▒░░    WHATS WHAT    ░░▒▒▓▓██▓▓▒▒░░║
  105.                 ╚══════════════════════════════════════════════╝
  106.  
  107.   Below is a list of the included files and brief description of what they
  108.   do. The files at the time of shipment were in fine working order and have
  109.   been tested. Micro Alpha assumes no responsibility for any damages caused
  110.   or incurred from people tampering with the files.....
  111.  
  112.     PRINTERS.DOC - This Doc File.
  113.   * PRINTERS.EXE - The Executable PRINTERS Program.
  114.   * MATRIX.DAT   - ASCII Version of Clarions MATRIX.CTL In Clarion File Format.
  115.   * MATRIX.K01   - Key File For Matrix Printer Name Lookups.
  116.   * LASER.DAT    - ASCII Version of Clarions LASER.CTL In Clarion File Format.
  117.   * LASER.K01    - Key File For Laser Printer Name Lookups.
  118.   * PRINTER1.DAT - HEX Version of Clarions MATRIX.CTL In Clarion File Format.
  119.   * PRINTER1.K01 - Key File.
  120.   * PRINTER2.DAT - HEX Version of Clarions LASER.CTL In Clarion File Format.
  121.   * PRINTER2.K01 - Key File.
  122.   * PRINTERS.HLP - The Help File Used By PRINTERS.
  123.     PRN_CDS.DAT  - Empty Selected Printer File For "GETTING" into your APP.
  124.     PRN_CDS.INC  - Include file containing file srtucture of PRN_CDS.DAT.
  125.     SAMPLE.APP   - A Sample Application (Check it out!)
  126.     SAMPLE.DOC   - A doc file for the Sample App
  127.     SAMPLE.HLP   - The Help file for the Sample App
  128.  
  129. * - These files must be included with your application distribution disks.
  130.                                                                     PG 2
  131.  
  132.  
  133.  
  134.                 ╔══════════════════════════════════════════════╗
  135.                 ║░░▒▒▓▓██▓▓▒▒░░  IMPLIMENTATION  ░░▒▒▓▓██▓▓▒▒░░║
  136.                 ╚══════════════════════════════════════════════╝
  137.  
  138.   First you must get the file definition into your application. From within
  139.   the designer you may GET the file structure from the included blank PRN_CDS
  140.   file. When using the editor simply COPY the PRN_CDS.INC into your file defs.
  141.   To impliment the PRN_CDS.DAT file which is created when the user selects
  142.   a printer, simply use the code list provided in this document to
  143.   find the field that represents the code for which you wish to use, and
  144.   use this field in the "CONTROL FIELD" box of the the report formatter.
  145.   Remember, that before the report is run you must first GET the record
  146.   to load the selected printer. This can be done in the designer by
  147.   defining a SETUP PROCEDURE for the report with the following line of
  148.   code: 'GET(PRN_CDS,1)' (without the quotes of course). From the editor
  149.   issue the same command to get the record. You may want to do some
  150.   error checking to see if the user has selected a printer. Note that the
  151.   C:PTR_TYP field of the PRN_CDS file returns which type of printer the
  152.   end user has selected. Knowing this, you can add conditional statements
  153.   in your report development to handle the annoying 66 lines for Dot Matrix
  154.   vs. 60 lines for Laser problems.
  155.  
  156.  
  157.                 ╔══════════════════════════════════════════════╗
  158.                 ║░░▒▒▓▓██▓▓▒▒░░     THE CATCH    ░░▒▒▓▓██▓▓▒▒░░║
  159.                 ╚══════════════════════════════════════════════╝
  160.  
  161.   As this is a shareware package, not a demo, it is a working version of
  162.   the program. It does however have one limitation. Hopefully we have made
  163.   the shareware screens so pathetic that you wont include it in your APP
  164.   until you register. The registered version is identical except for the
  165.   shareware notices.   (SORRY BUT I HAVE TO GENERATE REVENUE SOMEHOW!)
  166.  
  167.                 ╔══════════════════════════════════════════════╗
  168.                 ║░░▒▒▓▓██▓▓▒▒░░  THE CODE LIST   ░░▒▒▓▓██▓▓▒▒░░║
  169.                 ╚══════════════════════════════════════════════╝
  170.  
  171.   Below is a listing of all the available control codes for you to use in
  172.   the generation of your reports. Simply use the code on the left in your
  173.   reports to achieve the effect listed on the right.
  174.  
  175.  
  176.                       C:CPI10   =  10 CPI
  177.                       C:CPI12   =  12 CPI
  178.                       C:BON     =  Bold On
  179.                       C:BOFF    =  Bold Off
  180.                       C:CSB     =  Char Set - Bar Code
  181.                       C:CSL     =  Char Set - Legal
  182.                       C:CSLD    =  Char Set - Line Draw
  183.                       C:CSM7    =  Char Set - Math #7
  184.                       C:CSM8    =  Char Set - Math #8
  185.                       C:CSPC    =  Char Set - PC
  186.                       C:CSPF    =  Char Set - Pifont
  187.                       C:CSRE    =  Char Set - Roman Exn
  188.                       C:CSR8    =  Char Set - Roman #8
  189.                       C:CSUPS   =  Char Set - UPC
  190.                       C:CH1     =  Character Set #1
  191.                       C:CH2     =  Character Set #2
  192.                       C:CON     =  Compressed On
  193.                       C:COFF    =  Compressed Off
  194.  
  195.  
  196.                                                                     PG 3
  197.  
  198.  
  199.                 ╔══════════════════════════════════════════════╗
  200.                 ║░░▒▒▓▓██▓▓▒▒░░  THE CODES CONT  ░░▒▒▓▓██▓▓▒▒░░║
  201.                 ╚══════════════════════════════════════════════╝
  202.  
  203.                       C:CS10    =  Correspondance 10CPI
  204.                       C:CS12    =  Correspondance 12CPI
  205.                       C:DHON    =  Double Height On
  206.                       C:DHOFF   =  Double Height Off
  207.                       C:DWON    =  Double Wide On
  208.                       C:DWOFF   =  Double Wide Off
  209.                       C:EMON    =  Emphasized On
  210.                       C:EMOFF   =  Emphasized Off
  211.                       C:EXON    =  Expanded On
  212.                       C:EXOFF   =  Expanded Off
  213.                       C:FU      =  Floating Underline
  214.                       C:FC      =  Font - Courier
  215.                       C:FD      =  Font - Draft
  216.                       C:FH      =  Font - Helvetica #2
  217.                       C:FL      =  Font - Letter Gothic
  218.                       C:FLP     =  Font - Line Printer
  219.                       C:FP      =  Font - Prestige
  220.                       C:FSS     =  Font Sans Serif
  221.                       C:FS      =  Font Script
  222.                       C:FTR     =  Font - Times Roman
  223.                       C:FC1     =  Font Cart #1
  224.                       C:FC2     =  Font Cart #2
  225.                       C:FF      =  Form Feed
  226.                       C:ID1     =  Internat: Denmark #1
  227.                       C:ID2     =  Internat: Denmark #2
  228.                       C:IF1     =  Internat: France #1
  229.                       C:IG1     =  Internat: Germany #1
  230.                       C:II1     =  Internat: Italy #1
  231.                       C:IJ1     =  Internat: Japan #1
  232.                       C:ISP     =  Internat: Spain #1
  233.                       C:ISW     =  Internat: Sweeden #1
  234.                       C:IUK     =  Internat: United Kingdom #1
  235.                       C:IUS     =  Internat: USA #1
  236.                       C:ION     =  Italic On
  237.                       C:IOFF    =  Italic Off
  238.                       C:LMON    =  Landscape Mode On
  239.                       C:LMOFF   =  Landscape Mode Off
  240.                       C:NLON    =  Near Letter On
  241.                       C:NLOFF   =  Near Letter Off
  242.                       C:OCRA    =  OCR a
  243.                       C:OCRB    =  OCR B
  244.                       C:OCRBX   =  OCR B Ext
  245.                       C:P6      =  Pitch 6
  246.                       C:P8      =  Pitch 8
  247.                       C:P10     =  Pitch 10
  248.                       C:P12     =  Pitch 12
  249.                       C:P14     =  Pitch 14
  250.                       C:P16     =  Pitch 16.66
  251.                       C:PT6     =  Point 6
  252.                       C:PT8     =  Point 8
  253.                       C:PT10    =  Point 10
  254.                       C:PT12    =  Point 12
  255.                       C:PT14    =  Point 14
  256.                       C:PON     =  Proportional On
  257.                       C:POFF    =  Proportional Off
  258.                       C:QMON    =  Quiet Mode On
  259.                       C:QMOFF   =  Quiet Mode Off
  260.  
  261.  
  262.                                                                     PG 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                 ╔══════════════════════════════════════════════╗
  270.                 ║░░▒▒▓▓██▓▓▒▒░░  THE CODES CONT  ░░▒▒▓▓██▓▓▒▒░░║
  271.                 ╚══════════════════════════════════════════════╝
  272.  
  273.  
  274.                       C:RS      =  Re Set
  275.                       C:SB      =  Stroke - Bold
  276.                       C:SL      =  Stroke - Light
  277.                       C:SM      =  Stroke - Medium
  278.                       C:SBON    =  Subscript On
  279.                       C:SBOFF   =  Supscript Off
  280.                       C:SHON    =  Shadow On
  281.                       C:SHOFF   =  Shadow Off
  282.                       C:SSON    =  Superscript On
  283.                       C:SSOFF   =  Superscript Off
  284.                       C:UON     =  Underline On
  285.                       C:UOFF    =  Underline Off
  286.                       C:VS6     =  Vertical Spacing 6 LPI
  287.                       C:VS8     =  Vertical Spacing 8LPI
  288.                       C:VS10    =  Vertical Spacing 10LPI
  289.                       C:ZS      =  Zero - Slashed
  290.                       C:ZU      =  Zero - Unslashed
  291.                       C:PTR_TYP = *
  292.  
  293. * This field contains either a "M" or a "L" depending on which printer type
  294.   was selected (M=Dot Matrix and L=Laser).
  295.  
  296.  
  297.    NOTE: Although all of the possible control codes are listed, not all
  298. are supported by every printer. If you are unsure whether a printer
  299. supports a code, refer to that specific printers manual.
  300.  
  301.  
  302.  
  303.                 ╔══════════════════════════════════════════════╗
  304.                 ║░░▒▒▓▓██▓▓▒▒░░      THANKS      ░░▒▒▓▓██▓▓▒▒░░║
  305.                 ╚══════════════════════════════════════════════╝
  306.  
  307.   We hope you find this product useful. Should you have any questions or
  308. comments, please write. And remember.... Thanks For Supporting Shareware!
  309.  
  310.  
  311.